home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / tex-faq < prev    next >
Encoding:
Text File  |  1995-07-25  |  60.2 KB  |  1,217 lines

  1. Subject: TeX, LaTeX, etc.: Frequently Asked Questions with Answers [Monthly]
  2. Newsgroups: comp.text.tex,fr.comp.text.tex,comp.answers,news.answers
  3. From: bobby@hot.caltech.edu (Bobby Bodenheimer)
  4. Date: 8 Nov 1994 04:08:37 GMT
  5.  
  6. Archive-name: tex-faq
  7.  
  8. Comp.text.tex is a forum for the discussion of TeX, LaTeX and other
  9. related things. TeX is a software system written by Donald Knuth to
  10. typeset text, especially text containing mathematics. LaTeX is a set
  11. of macros written in TeX, designed to simplify the the typesetting of
  12. a document by allowing the user to concentrate on the content and
  13. structure of the document rather than the exact appearance of the
  14. finished product. METAFONT, also discussed here, is a program which
  15. allows the user to design their own fonts. The definitive reference
  16. for TeX is _The TeXbook_, by Donald Knuth (Addison Wesley, 1984, ISBN
  17. 0-201-13447-0, paperback 0-201-13448-9). For LaTeX, see _LaTeX, a
  18. Document Preparation System_ by Leslie Lamport (Addison Wesley, 1986,
  19. ISBN 0-201-15790-X); the second edition of this book covers LaTeX2e.
  20. Full documentation for LaTeX2e can be found in _The LaTeX Companion_
  21. by Michael Goossens, Frank Mittelbach, and Alexander Samarin (Addison
  22. Wesley, 1993, ISBN 0-201-54199-8). For METAFONT, see _The
  23. METAFONTbook_ by Donald Knuth (Addison Wesley, 1984, ISBN
  24. 0-201-13445-4). The American Mathematical Society has two macro
  25. packages which are also popular, called AMS-TeX and AMS-LaTeX.
  26.  
  27. This article contains answers to some frequently asked questions on
  28. comp.text.tex. Please don't ask these questions again, as they've been
  29. answered many times before.
  30.  
  31. Malencontreusement, je n'ai ni le temps ni la comp\'etence pour
  32. traduire cet article en fran\c{c}ais. Je prie donc, le lecture
  33. interess\'e par fr.comp.text.tex d'avoir l'indulgence d'accepter la
  34. version anglaise.
  35.  
  36. This is version 1.48 for November, last changed 11/7/94.
  37.  
  38. This article includes answers to:
  39.  
  40.   1) How can I get a copy of this article?
  41.   2) Where can I get a DVI to PostScript conversion program?
  42.   3) How can I include a PostScript figure in LaTeX?
  43.   4) Where can I find a DVI previewer for machine Y running Q?
  44.   5) Where can I get the manual for PiCTeX?
  45.   6) In LaTeX, I put some definitions in my document, but I get the error
  46.      ``Use of \@ doesn't match its definition.'' What's wrong?
  47.   7) What is OzTeX and where can I get it (TeX for the Mac)?
  48.   8) What is Fig and where can I get it?
  49.   9) How do I get WEB for C, FORTRAN, or some other language?
  50.   10) How can I typeset music in TeX?
  51.   11) What is TUG and TUGboat?
  52.   12) How do I convert Adobe's afm files to tfm format?
  53.   13) In LaTeX, how do I get a double-spaced document?
  54.   14) In LaTeX, how do I include a file in the verbatim environment?
  55.   15) In LaTeX, how do I do Y?
  56.   16) Where can I find a TeX macro or LaTeX style file for doing Y?
  57.   17) How do I generate an index in TeX/LaTeX?
  58.   18) How do I get METAFONT to do what I want it to do?
  59.   19) Where do I get TeX/LaTeX for machine Y running Q?
  60.   20) Where can I get a thesis style for LaTeX?
  61.   21) How do I get symbols for ``the real numbers'', ``the complex numbers'',
  62.       and so on?
  63.   22) What repositories of TeX material are available, and how can I
  64.       access them?
  65.   23) How do I use PostScript fonts with LaTeX?
  66.   24) How can I convert from format Y to TeX or LaTeX, and vice-versa?
  67.   25) How do I get a file into the major style repositories?
  68.   26) Where can I get font Y?
  69.   27) Where can I get a dvi driver for the HP LaserJet?
  70.   28) TeX and LaTeX are hyphenating words weirdly. What can I do?
  71.   29) How can I convert a TeX or LaTeX file into a plain ASCII file,
  72.       with all the formatting intact, a la nroff?
  73.   30) How do I enlarge TeX? I keep getting ``memory capacity exceeded''
  74.       errors.
  75.   31) In LaTeX, I used \pagestyle{empty}, but the first page is still 
  76.       numbered. What do I do?
  77.   32) Where do I find documentation about BibTeX?
  78.   33) How do I use BibTeX with plain TeX?
  79.   34) How do I draw Feynman diagrams in LaTeX?
  80.   35) What is the New Font Selection Scheme (NFSS)?
  81.   36) In LaTeX, my cross-references for floats (figures and tables) are
  82.       incorrect. What's wrong?
  83.   37) I want to change the margins in LaTeX. What can I do?
  84.   38) How do I find the width of a letter, word, or phrase in TeX?
  85.   39) In LaTeX, is there a comment or ``ignore'' environment with which
  86.       I can exclude blocks of text from the .dvi file?
  87.   40) Where can I find a spelling checker for my TeX file?
  88.   41) What is LaTeX2e?
  89.   42) In LaTeX, how can I define a new log-like function?
  90.   43) In LaTeX, how do I put a \sqrt in my \caption statement?
  91.   44) In LaTeX, how do I get thin and thick \hlines in a table?
  92.   45) In LaTeX, how do I number the bibliography using Arabic numbers without
  93.       square brackets or using superscripts?
  94.   46) In LaTeX, why are my cites all numbered zero?
  95.   47) In LaTeX, my figures get put on a page by themselves with too much
  96.       whitespace, but when I tried \begin{figure}[t] they get printed at
  97.       the end. Why?
  98.   48) In LaTeX, how do I make a line break in a section title?
  99.   49) In LaTeX, how do I number equations by section?
  100.  
  101. If you are looking, for instance, for the answer to question 17, and wish
  102. to skip everything else, you can search ahead for the regular expression
  103. ``^17)''.
  104.  
  105. These are all legitimate questions, but they seem to appear too 
  106. frequently for long-time readers of the list. 
  107.  
  108. Many of the answers below tell you that you can obtain something
  109. through anonymous ftp. ``Ftp'' stands for file transfer protocol, and
  110. is also the name of a program implementing the protocol. The program
  111. allows users to transfer files to and from remote sites, if the sites
  112. are connected via a network such as the Internet. ``Anonymous ftp'' 
  113. indicates a user may connect to a remote site as the user 
  114. ``anonymous'' with a password consisting of their email address, and
  115. thus be able to retrieve files from that site. Remember, anonymous
  116. ftp is a privilege and the system administrators for these sites 
  117. have made these files available out of their own generosity. Therefore
  118. please restrict your ftp'ing to non-prime hours at the various sites.
  119.  
  120. I would like to acknowledge Don Hosek, Ken Yap, Tomas Rokicki, Micah
  121. Beck, David Carlisle, and Donald Arseneau who provided many of the
  122. answers.  Joe Weening, Hal Perkins, Walter Carlip, Max Hailpern, Tad
  123. Guy, Raymond Chen, Henning Schulzrinne, Sebastian Rahtz, Mark James,
  124. Peter Galko, Mike Ernst, Rainer Sch\"opf, Oren Patashnik, Philippe
  125. Louarn, Rafal Zbikowski, Anita Marie Hoover, David Rhead, Darrell
  126. McCauley, Cameron Smith, Emma Pease, Patrick McPhee, Karl Berry, Robin
  127. Fairbairns, Joohee Jeong, Sam Steingold, J\"org Knappen, Barbara
  128. Beeton, Norman Ramsay, and Richard Mathar provided additional material
  129. and criticisms. The format of this document is based on the Frequently
  130. Asked Questions written by Steve Hayman which formerly appeared in
  131. comp.unix.wizards. Any mistakes are mine. Send corrections,
  132. suggestions, and additions to bobby@hot.caltech.edu.
  133.  
  134. 1) How can I get a copy of this article?
  135.  
  136.    You're reading it aren't you? SAVE it :-). This article is posted
  137.    monthly to comp.text.tex and cross-posted to news.answers. It is
  138.    therefore archived at any site that archives news.answers.
  139.    News.answers is archived on rtfm.mit.edu, and this article is
  140.    available there via anonymous ftp in the directory
  141.    ./pub/usenet/news.answers/tex-faq. If you do not have anonymous
  142.    ftp, send an e-mail message containing the lines ``SENDME FAQ.'' to
  143.    fileserv@shsu.edu (fileserv@shsu.bitnet).  Another way to retrieve
  144.    it via email is through the mailserver at rtfm: send a message
  145.    containing the lines ``help'' and ``index'' to
  146.    mail-server@rtfm.mit.edu for information on how to obtain it.
  147.  
  148.    Other news.answers/FAQ archives are: cnam.cnam.fr (163.173.128.6)
  149.    in the anonymous ftp directory /pub/FAQ; ftp.uu.net (192.48.96.2)
  150.    in the anonymous ftp directory /pub/usenet (also available via mail
  151.    server requests to netlib@uunet.uu.net, or via uunet's 1-900
  152.    anonymous UUCP phone number); and ftp.cs.ruu.nl (131.211.80.17) in
  153.    the anonymous ftp directory NEWS.ANSWERS (also accessible via mail
  154.    server requests to mail-server@cs.ruu.nl). Many of the archives
  155.    mentioned in question 22 also maintain current versions of this
  156.    document.
  157.  
  158. 2) Where can I get a DVI to PostScript conversion program?
  159.  
  160.    Two good DVI to PostScript conversion programs that run under
  161.    Unix are:
  162.      dvips - by Tomas Rokicki. This driver is very nice and has the
  163.        ability to deal with virtual fonts. Available via anonymous ftp
  164.        from labrea.stanford.edu (36.8.0.112) in ./pub. Dvips is
  165.        written in C and ports easily to other operating systems.  It
  166.        is available for VMS via anonymous ftp from any CTAN site (see
  167.        question 22) and also through the DECUS library (see question
  168.        22). A precompiled version for MSDOS is available from
  169.        monu1.cc.monash.edu.au (130.194.1.101) in ./pub/dvips54.zip,
  170.        from shape.mps.ohio-state.edu (128.146.110.30) in
  171.        ./pub/msdos/dvips/dvips54.zip, or from any CTAN site (see
  172.        question 22) in ./systems/msdos/drivers/dvips.  If you wish to
  173.        use postscript fonts, get dvipslib.zip as well.  Documentation
  174.        is available in dvips.ps.Z. Karl Berry has a version of dvips
  175.        called dvipsk which has a configure script and path searching
  176.        code similar to that in his other programs (e.g., web2c).  It
  177.        is available via anonymous ftp from ftp.cs.umb.edu
  178.        (158.121.104.33) in ./pub/tex/.
  179.  
  180.      dvitops - by James Clark. Available via anonymous ftp from any CTAN site
  181.        (see question 22, e.g., pip.shsu.edu (192.92.115.10)), in 
  182.        ./tex-archive/dviware/dvitops. Dvitops is written in C and will 
  183.        compile under Unix, MSDOS, VMS, and Primos.
  184.  
  185. 3) How can I include a PostScript figure in LaTeX?
  186.  
  187.    In LaTeX2e, the best way is \usepackage[dvips]{graphics}.
  188.  
  189.    Perhaps the best way to do this is to use the psfig macros written
  190.    by Trevor Darrell. They are available via anonymous ftp from
  191.    any CTAN site (see question 22) in graphics/psfig. You will
  192.    also need a dvi to PostScript conversion program that supports
  193.    \specials. The ones mentioned in question 2 do, and come with a
  194.    version of psfig ready to use with them. The psfig macros work best
  195.    with Encapsulated PostScript Files (EPS). In particular, psfig will
  196.    need the file to have a BoundingBox (see Appendix C of the
  197.    _PostScript Language Reference Manual_). If you don't have an EPS
  198.    file, life can be difficult.
  199.  
  200.    To allow resizing by dvips (see question 2) with PostScript files
  201.    that are not EPS files, add the one line comment
  202.    %%BoundingBox: llx lly urx ury" 
  203.    prior to any non-comment line in the PostScript file. The four
  204.    ``lower left'' and ``upper right'' arguments must be numbers to
  205.    indicate the lower left and upper right corner in units of 1/72 of
  206.    an inch. Otherwise, dvips assumes the PostScript file fills a whole
  207.    page.
  208.  
  209.    One further note about including PostScript figures is that they
  210.    are not part of the dvi file, but are included when you use a dvi
  211.    to PostScript conversion program. As a result, most dvi previewers
  212.    will simply show the blank space TeX has reserved for your figure,
  213.    not the figure itself. LaTeX2e (see question 41) will have a standard
  214.    interface for graphics inclusion, rotation, color, and other 
  215.    driver-related features.
  216.  
  217.    Anil K. Goel has written a long document describing in detail how to
  218.    include figures, pictures, and images in LaTeX documents. It is available
  219.    via anonymous ftp from math.uwaterloo.ca (129.97.140.144) in
  220.    ./pub/figsInLatex.ps.Z. A dvi file with the included PostScript files
  221.    is also available.
  222.  
  223. 4) Where can I find a DVI previewer for machine Y running Q?
  224.  
  225.    This briefly lists some previewers available via anonymous ftp. All
  226.    are available from any CTAN site (see question 22) in addition to the
  227.    sites listed below:
  228.       dvipage - For SunView. This was published in volume 15 of 
  229.         comp.sources.unix and is available at sites that archive
  230.         this. One such source is archive.cis.ohio-state.edu 
  231.         (128.146.8.52).
  232.       xtex - For the X Window System. Available via anonymous ftp 
  233.         from ftp.cs.colorado.edu (128.138.243.151) in 
  234.         ./pub/cs/misc/SeeTeX/SeeTeX/SeeTeX-*.tar.Z.
  235.       dviapollo- for Apollo Domain. Available via anonymous ftp from
  236.         labrea.stanford.edu (36.8.0.112) in ./pub/dviapollo.tar.Z.
  237.       dvidis - For VAXstation VWS. Available via anonymous ftp from
  238.         src.doc.ic.ac.uk (146.169.2.1) in /packages/tex/dviware/dvidis.
  239.       xdvi - Also for the X Window System. Available via anonymous ftp
  240.         from ftp.x.org (192.112.44.100) in ./contrib/xdvi.tar.Z. Karl
  241.         Berry has a version of called xdvik with features analogous
  242.         to his dvipsk (see question 2) available via anonymous ftp from
  243.         ftp.cs.umb.edu (158.121.104.33) in ./pub/tex.
  244.       dvitovdu - for Tektronix 4010 and other terminals under Unix.
  245.         Available via anonymous ftp from wsmr-simtel20.army.mil
  246.         (192.88.110.20) in the directory pd6:<unix-c.printers> as
  247.         dvi2vdu.tar-z (ftp in ``tenex'' mode).
  248.       dvi2tty - A dvi to ASCII conversion program, for normal terminals.
  249.         Available from ftp.cs.ruu.nl (131.211.80.17) in 
  250.         ./pub/TEX/DVI/dvi2tty.shar. A VMS version is available from
  251.         fileserv@shsu.edu (see question 22).
  252.       texsgi - For SGI under Irix. Available via anonymous ftp from 
  253.         ftp.brl.mil (128.63.16.158) in ./info-iris/tex. Both a binary 
  254.         and source are available, but be sure to get the fonts as well.
  255.    
  256. 5) Where can I get the manual for PiCTeX?
  257.  
  258.    The PiCTeX manual is not free. It is available for $30 ($35 with the
  259.    disk) from the TeX Users Group:
  260.                      TeX Users Group
  261.                      P. O. Box 869
  262.                      Santa Barbara, CA 93102-0869 (USA)
  263.                      805-963-1338
  264.                      FAX: 805-963-8358
  265.                      tug@tug.org
  266.  
  267.    The proceeds from this sale go to Michael Wichura, the author of PiCTeX,
  268.    and TUG.
  269.  
  270. 6) In LaTeX, I put some definitions in my document, but I get the error
  271.    ``Use of \@ doesn't match its definition.'' What's wrong?
  272.  
  273.    Definitions should be be in a style file, and if you move them there,
  274.    you should have no problem.
  275.  
  276.    If you don't want to do that, you need to include \makeatletter
  277.    before the definitions to allow the ``internal'' LaTeX commands to
  278.    be accessed.  These commands are normally protected from change by
  279.    having @ in them.  Since @ is not a letter, it is normally not
  280.    allowed as part of a multi-letter command name. To access internal
  281.    commands you need to tell LaTeX to pretend that @ is a letter.
  282.    This happens automatically when LaTeX reads a style file, but in
  283.    your main document you need to surround the offending commands with
  284.    \makeatletter ... \makeatother.
  285.  
  286. 7) What is OzTeX and where can I get it (TeX for the Mac)?
  287.  
  288.    OzTeX is a public domain version of TeX for the Macintosh. A DVI
  289.    Previewer and PostScript driver are also included. It should run on
  290.    any Macintosh Plus, SE, II, or newer model, but will not work on a
  291.    128K or 512K Mac. It was written by Andrew Trevorrow, and is available 
  292.    via anonymous ftp from from midway.uchicago.edu (128.135.12.73) in 
  293.    ./pub/OzTeX, which contains other public domain TeX-related software 
  294.    for the Mac as well, or on a floppy disk from TUG (see question 11). 
  295.    Questions about OzTeX may be directed to oztex@midway.uchicago.edu.
  296.    
  297. 8) What is Fig and where can I get it?
  298.  
  299.    Fig is a menu driven tool similar to MacDraw that allows you to
  300.    draw objects on the screen of a Sun Workstation running SunView.
  301.    TransFig is a set of tools which translate the code fig produces to
  302.    other graphics languages including PostScript and the LaTeX picture
  303.    environment. Both are available via anonymous ftp from
  304.    ftp.cs.cornell.edu (128.84.218.75) in ./pub/fig. Both Fig and
  305.    TransFig are also available from the Clarkson archive server at
  306.    sun.soe.clarkson.edu (see question 22). Fig is supported by Micah
  307.    Beck (beck@cs.cornell.edu) and Transfig is maintained by Brian
  308.    Smith (bvsmith@lbl.gov). Another tool for fig conversion is fig2MF
  309.    which generates METAFONT code from fig input. It is available from
  310.    the CTAN archives discussed in question 22.
  311.  
  312.    XFig is essentially the same program except it runs under the X
  313.    Window System. It is available via anonymous ftp from ftp.x.org
  314.    (192.112.44.100) in ./contrib/applications/drawing_tools/xfig. It
  315.    was written by Brian Smith.
  316.  
  317. 9) How do I get WEB for C, FORTRAN, or some other language?
  318.  
  319.    TeX is written in the programming language WEB; WEB is a tool to
  320.    implement the concept of ``literate programming.'' For more information
  321.    on literate programming, see the newsgroup comp.programming.literate.
  322.  
  323.    There is a version of WEB for C called CWEB written by Silvio Levy. It
  324.    is available via anonymous ftp from princeton.edu (128.112.128.1) in 
  325.    the directory ./pub/cweb.
  326.  
  327.    There is a version of WEB called Spidery WEB which supports many 
  328.    languages including ADA, awk, and C. It was written by Norman Ramsey 
  329.    and, while not in the public domain, is usable free. It is available 
  330.    via anonymous ftp from pip.shsu.edu (192.92.115.10) in 
  331.    tex-archive/web/spiderweb.
  332.  
  333.    FWEB is a version of WEB for Fortran, Ratfor, and C written by John
  334.    Krommes (krommes@lyman.pppl.gov). Version 1.13 is available via
  335.    anonymous ftp from lyman.pppl.gov (192.55.106.129) in ./pub/fweb.
  336.  
  337.    SchemeWEB is a Unix filter that translates SchemeWEB into LaTeX source
  338.    or Scheme source. It was written by John Ramsdell and is available from
  339.    sun.soe.clarkson.edu (128.153.12.3) in ./pub/tex/tex-programs/schemeweb.
  340.  
  341.    APLWEB is a version of WEB for APL and is available from
  342.    watserv1.waterloo.edu (129.97.129.140) in ./languages/apl.
  343.  
  344.    There are three flavors of WEB that are language-independent and
  345.    have substantial user communities: funnelweb, noweb, and nuweb.
  346.    NoWeb and NuWeb both emphasize simplicity; NoWeb is a bit simpler
  347.    and more flexible, but NuWeb is more portable and easier to
  348.    install.  FunnelWeb is more complex, but is routinely used on a
  349.    wide variety of machines.  All three systems are available from any
  350.    CTAN site (see question 22) in directory
  351.    /tex-archive/web/{funnelweb,noweb,nuweb}.  An introduction to NoWeb
  352.    appeared in the September 1994 IEEE Software, page 97.  Funnelweb
  353.    also appeared in comp.sources.unix volume 26 issue 121, posted 11
  354.    April 1993.
  355.  
  356.    Most of the above are also available from your nearest CTAN site
  357.    (see question 22).
  358.  
  359. 10) How can I typeset music in TeX?
  360.  
  361.     A package called MuTeX, written by Andrea Steinbach and Angelika
  362.     Schofer, aids in doing this. It is available via anonymous ftp
  363.     from ftp.cs.ruu.nl (131.211.80.17) in pub/TEX/MuTeX.tar.Z.  This
  364.     package allows you to typeset single-staff music and lyrics.
  365.  
  366.     A more powerful package which allows the typesetting of orchestral
  367.     and polyphonic music is MusicTeX, written by Daniel Taupin 
  368.     (taupin@frups51.bitnet). It is available via anonymous ftp from
  369.     rsovax.ups.circe.fr (130.84.128.100) [.musictex]. It should also
  370.     be available from the archive sites detailed in question 22.
  371.  
  372.     There is a mailing list for discussion of typesetting music in TeX.
  373.     To subscribe, send a request to mutex-request@stolaf.edu.
  374.  
  375. 11) What is TUG and TUGboat?
  376.  
  377.     TUG is the TeX Users Group. TUGboat is their newsletter, containing
  378.     useful articles about TeX and METAFONT. TUG also distributes
  379.     TeX-related microcomputer software on disks. Inquiries should be 
  380.     directed to:
  381.                      TeX Users Group
  382.                      P. O. Box 869
  383.                      Santa Barbara, CA 93102-0869 (USA)
  384.                      805-963-1338
  385.                      FAX: 805-963-8358
  386.                      tug@tug.org
  387.  
  388. 12) How do I convert Adobe's afm files to tfm format?
  389.  
  390.     An afm2tfm program is distributed with dvips, available via
  391.     anonymous ftp from labrea.stanford.edu (36.8.0.112) in ./pub. Alan
  392.     Jeffrey's fontinst package is an afm2tfm converter written in TeX 
  393.     and will be used to support the PostScript tfm files for LaTeX2e
  394.     (see question 41). It is available from any CTAN site (see question
  395.     22).
  396.  
  397.     For the Macintosh, there is a program called EdMetrics which does
  398.     the job (and more). It is available free from:
  399.               Blue Sky Research
  400.               534 Southwest Third Avenue
  401.               Portland, Oregon 97204 (USA)
  402.               800-622-8398 or 503-222-9571
  403.  
  404. 13) In LaTeX, how do I get a double-spaced document?
  405.  
  406.     Are you producing a thesis, and trying to obey regulations that were
  407.     drafted in the typewriter era?  LaTeX is a typesetting system, so the
  408.     appropriate design conventions are for ``real books''.  Find whoever
  409.     is responsible for the regulations, and try to get the wording changed
  410.     to cater for typeset theses (e.g., to say ``if using a typesetting 
  411.     system, aim to make your thesis look like a well-designed book'').
  412.  
  413.     If you fail to convince your officials, or want some inter-line 
  414.     space for copy-editing:
  415.      - In LaTeX2e, use \linespread. For double-spaced output, use
  416.        \linespread{1.6}.
  417.      - Try changing \baselinestretch: \renewcommand{\baselinestretch}{1.2}
  418.        may be enough to give officials the impression you've kept
  419.        to their regulations.  Don't try changing \baselineskip: its
  420.        value is reset at any size-changing command.
  421.      - Alternatively, get doublespace.sty from any CTAN site (see question 22,
  422.        e.g., pip.shsu.edu (192.92.115.10)) in 
  423.        ./tex-archive/macros/latex/contrib/misc. There's also a setspace.sty
  424.        in the same directory which is more flexible, and consistent with the
  425.        latest release of LaTeX.
  426.  
  427.     It's not worth going to a lot of trouble.  (If officials won't allow
  428.     standard typographic conventions, you won't be able to produce an
  429.     aesthetically pleasing document anyway!)
  430.  
  431. 14) In LaTeX, how do I include a file in the verbatim environment?
  432.  
  433.     A good way to do this is to use Rainer Sch\"opf's verbatim.sty,
  434.     which provides the command \verbatiminput that takes a file
  435.     as an argument. This package is available from any CTAN site (see 
  436.     question 22) in ./tex-archive/macros/latex/distribs. Several
  437.     files are needed.
  438.  
  439.     Another way to do this is to use the alltt environment defined in
  440.     the style file alltt.sty available from the CTAN archives in 
  441.     ./tex-archive/macros/latex/contrib/misc/alltt.sty.
  442.  
  443. 15) In LaTeX, how do I do Y?
  444.  
  445.     If you can't figure out how to do something in LaTeX after you
  446.     have read the manual very carefully, asked your local LaTeX
  447.     guru, and thought about it, there is a LaTeX help service 
  448.     available. Please note that the way to accomplish something 
  449.     in LaTeX is often by using an appropriate style file, so please
  450.     check this also (see question 16). If none of this works, send mail 
  451.     in English describing your problem to latex-help@cs.stanford.edu. 
  452.     If you haven't gotten a reply to your problem within about a week, 
  453.     send mail to latex-help-coordinator@cs.stanford.edu.
  454.  
  455. 16) Where can I find a TeX macro or LaTeX style file for doing Y?
  456.  
  457.     Before you ask for a TeX macro or LaTeX style file to do something, 
  458.     please search the TeX macro index written by David M. Jones
  459.     (dmjones@theory.lcs.mit.edu) and available via anonymous ftp
  460.     from theory.lcs.mit.edu (18.52.0.92) in ./pub/tex/TeX-index. Those 
  461.     without access to anonymous ftp can send a message containing the
  462.     line ``send tex TeX-index'' to archive-server@theory.lcs.mit.edu.
  463.     The index is an excellent reference document with plenty of 
  464.     cross-references. Also, many of the archive sites mentioned in
  465.     question 22 maintain extensive latex style collections, which you
  466.     can look through if you need something not in the index.
  467.  
  468.     Another possibility is to use the searching features of the CTAN
  469.     archives (see question 22). Once you have an anonymous ftp connection
  470.     established to a CTAN site, you can type the command `quote site index
  471.     <term>' and it will provide a list of files with the string <term> in
  472.     their names.
  473.     
  474. 17) How do I generate an index in TeX/LaTeX?
  475.  
  476.     Making an index is not trivial. There are several indexing programs
  477.     which aid in doing this. The following are available from any CTAN
  478.     site (see question 22):
  479.       makeindex - for LaTeX under Unix (but runs under other OS's
  480.          without changes). A version for the Macintosh is available from
  481.          Johnny Tolliver at tolliver%atf.mfenet@nmfecc.llnl.gov. The 
  482.          Makeindex documentation is a good source of information on how 
  483.          to create your own index. Makeindex can be used with some TeX macro
  484.          packages other than LaTeX, such as Eplain.
  485.       idxtex - for LaTeX under VMS.
  486.       texix - for TeX on CMS and Macintosh machines.
  487.       texindex - for LaTeX under Unix. Available from
  488.          comp.sources.misc archives in Volume 23.
  489.  
  490. 18) How do I get METAFONT to do what I want it to do?
  491.  
  492.     METAFONT allows you to create your own fonts, and ordinary TeX users
  493.     will never need to use it. METAFONT, unlike TeX, requires some 
  494.     customization. Each output device for which you will be generating 
  495.     fonts needs a mode associated with it. Modes are defined using the 
  496.     mode_def convention described on page 94 of _The METAFONTbook_. So 
  497.     first create a file, which we will call local.mf, containing all the 
  498.     mode_defs you will be using. The file modes.mf by Karl Berry,
  499.     available via anonymous ftp from ftp.cs.umb.edu (158.121.104.33) in
  500.     ./pub/tex is a good starting point for this. Listings of settings for 
  501.     various output devices are also published periodically in TUGboat 
  502.     (see question 11). Now create a plain base file using inimf, plain.mf, 
  503.     and local.mf:
  504.        % inimf
  505.        This is METAFONT....
  506.        **plain                 # you type plain
  507.        (output)
  508.        *input local            # you type this
  509.        (output)
  510.        *dump                   # you type this
  511.        Beginning to dump on file plain....
  512.        (output)
  513.        %
  514.     This should create a base file named plain.base (or something close)
  515.     and should be moved to the directory containing the base files on
  516.     your system.
  517.  
  518.     Now you need to make sure METAFONT loads this base when it starts
  519.     up. If METAFONT loads the plain base by default on your system, then
  520.     you're ready to go. Under Unix, we might, for instance define a 
  521.     command mf which executes ``virmf &plain,'' loading the plain base
  522.     file.
  523.  
  524.     The usual way to create a font with plain METAFONT is to then start 
  525.     it with the line
  526.        \mode=<mode name>; mag=<magnification>; input <font file name>
  527.     in response to the * prompt or on the METAFONT command line. If 
  528.     <mode name> is unknown or omitted, then the mode defaults to proof 
  529.     mode. If this has happened METAFONT will produce an output file
  530.     called <font file name>.2602gf. The <magnification> is a floating 
  531.     point number or magstep (magsteps are defined in _The METAFONTbook_ 
  532.     and _The TeXbook_). If mag=<magnification> is omitted, then the 
  533.     default is 1. For example, to generate cmr10 at 12pt for an epson 
  534.     printer you would type
  535.        mf \mode=epson; mag=1.2; input cmr10
  536.     Note that under Unix the '\' and ';' characters must usually be 
  537.     escaped, so this would typically look something like
  538.        mf \\mode=epson\; mag=1.2\; input cmr10
  539.  
  540.     If you don't have inimf or need a special mode that isn't in the
  541.     base, you can put its commands in a file (e.g., ln03.mf) and invoke
  542.     it on the fly with the \smode command. For example, to create 
  543.     ln03.300gf for an LN03 printer, using the file
  544.     % This is ln03.mf as of 2/27/90
  545.     % mode_def courtesy of John Sauter
  546.     proofing:=0;
  547.     fontmaking:=1;
  548.     tracingtitles:=0;
  549.     pixels_per_inch:=300;
  550.     blacker:=0.65;
  551.     fillin:=-0.1;
  552.     o_correction:=.5;
  553.     (note the absence of the mode_def and enddef commands), you would type
  554.        mf \smode="ln03"; input cmr10
  555.     
  556. 19) Where do I get TeX/LaTeX for machine Y running Q?
  557.  
  558.     Unix - The Unix TeX distribution is available via anonymous ftp from any 
  559.        CTAN archive (see question 22). The Northwest Computing Support Center
  560.        was ordered closed by the University of Washington, thus Unix TeX
  561.        can no longer be ordered.
  562.  
  563.        Instructions for retrieving TeX via anonymous ftp are available
  564.        in the document FTP.nwc, itself available via anonymous ftp from
  565.        ftp.cs.umb.edu (158.21.104.33) in ./pub/tex.
  566.  
  567.        Note: The Unix version of TeX allows your ``macros'' or ``inputs''
  568.        and ``fonts'' directories to be hierarchically organized with
  569.        further subdirectories, rather than dumping everything into one
  570.        directory. This can cause TeX to start very slowly. The cure
  571.        for this problem is to insure each subdirectory contains either
  572.        only directories or only files.
  573.  
  574.     AIX - TeX for the IBM RS6000 running AIX can be found on
  575.        ftp.dante.de (129.206.100.192) in ./tex-archive/systems/unix/aix3.2.
  576.  
  577.     386/ix - Executables for the 386/ix are available via anonymous ftp 
  578.        from tik.vtt.fi (130.188.52.2) in ./pub/tex/bin-386ix and from 
  579.        math.berkeley.edu (128.32.183.94) in ./pub/tex386ix.tar.Z.
  580.  
  581.     PC - A TeX package for the PC, including LaTeX, BibTeX, previewers,
  582.        and drivers is available via anonymous ftp from 
  583.        vax.eedsp.gatech.edu (130.207.226.24) in ./pub/TeX. The variety here
  584.        is sbtex version 30 by Wayne Sullivan. EmTeX, another TeX package 
  585.        for the PC by Eberhard Mattes, is available via anonymous ftp from 
  586.        ftp.dante.de (129.206.100.192) in 
  587.        ./tex-archive/systems/msdos/emtex and also from niord.shsu.edu
  588.        (192.92.115.8) in [.emtex]. This package includes LaTeX, METAFONT,
  589.        BibTeX, etc., as well. Documentation is available in both German 
  590.        and English.
  591.  
  592.     Mac - see question 7 for a public domain version (OzTeX). Another version
  593.        is CMacTeX, which has TeX 3.14, METAFONT 2.7, a screen previewer,
  594.        dvips, a PostScript printing utility for the LaserWriter, and some font
  595.        managing utilities. It is available from the CTAN archives discussed
  596.        in question 22. 
  597.  
  598.     TOPS-20 - TeX was originally written on a DEC-10 under WAITS, and so
  599.        was easily ported to TOPS-20. A Distribution that runs on TOPS-20 
  600.        is available via anonymous ftp from ftp.math.utah.edu 
  601.        (128.110.198.34) in ./pub/tex/pub/web.
  602.  
  603.     VAX/VMS - TeX for VMS is available from any CTAN site (see question 22)
  604.        in the directory ./systems/vms. Standard tape distribution is 
  605.        through DECUS.
  606.  
  607.     Atari - TeX is available for the Atari ST from atari.archive.umich.edu
  608.        (141.211.165.41) in ./atari/tex. If anonymous ftp is not available
  609.        to you, send a message containing the line ``help'' to
  610.        atari@atari.archive.umich.edu. The mail server can uuencode
  611.        binary files. Another version can be obtained via anonymous
  612.        ftp from ifi.informatik.uni-stuttgart.de (129.69.211.1) in
  613.        ./pub/atari.st/tex. There is also lots of TeX stuff for the
  614.        Atari on the CTAN and ftp.cs.ruu.nl archives mentioned in
  615.        question 22.
  616.  
  617.     Amiga - A full implementation of TeX 3.1 call PasTeX and METAFONT 2.7
  618.         are available via anonymous ftp from merlin.etsu.edu (192.43.199.20)
  619.         in ./ab20/AMIGA. It is also available via anonymous ftp from
  620.         forwiss.uni-passau.de (132.231.20.10) in ./pub/amiga/tex. 
  621.         You can also order a CDROM containing this and other amiga software
  622.         from Walnut Creek CDROM, (510) 947-5997.
  623.  
  624.     Tandy 6000 - If you are interested in building TeX on this machine
  625.         contact Ken Yap (ken@syd.dit.csiro.au), and he'll help you.
  626.  
  627. 20) Where can I get a thesis style for LaTeX?
  628.  
  629.     Thesis styles are usually very specific to your University, so it's
  630.     usually not profitable to ask the whole newsgroup for one. If you
  631.     want to write your own, a good place to start is the ucthesis style
  632.     available from any CTAN archive in macros/latex/contrib/ucthesis
  633.     (see question 22).
  634.  
  635. 21) How do I get symbols for ``the real numbers'', ``the complex numbers'',
  636.     and so on?
  637.  
  638.     These symbols are known as ``blackboard bold'' and are available in
  639.     the AMS fonts ``msam'' (e.g., ``msam10'' for 10pt) and ``msbm''. 
  640.     They replace the older ``msxm'' and ``msym''. The fonts have a large
  641.     number of mathematical symbols to supplement the ones 
  642.     provided by TeX. The fonts are available via anonymous ftp from
  643.     e-math.ams.com (130.44.1.100) in the directory ./ams/amsfonts.
  644.     Two files which load the fonts and define the symbols are provided,
  645.     and both work with either TeX or LaTeX. Questions or suggestions 
  646.     regarding these fonts should be directed to 
  647.     tech-support@math.ams.com.
  648.  
  649.     A geometric sans serif blackboard bold font by Alan Jeffrey is available
  650.     from any CTAN archive (see question 22) in ./tex-archive/fonts/bbold.
  651.  
  652.     A set of LaTeX macros for a ``lazy person's'' blackboard bold are:
  653.        \newcommand{\R}{{\sf R\hspace*{-0.9ex}\rule{0.15ex}%
  654.        {1.5ex}\hspace*{0.9ex}}}
  655.        \newcommand{\N}{{\sf N\hspace*{-1.0ex}\rule{0.15ex}%
  656.        {1.3ex}\hspace*{1.0ex}}}
  657.        \newcommand{\Q}{{\sf Q\hspace*{-1.1ex}\rule{0.15ex}%
  658.        {1.5ex}\hspace*{1.1ex}}}
  659.        \newcommand{\C}{{\sf C\hspace*{-0.9ex}\rule{0.15ex}%
  660.        {1.3ex}\hspace*{0.9ex}}}
  661.  
  662. 22) What repositories of TeX material are available, and how can I access
  663.     them?
  664.  
  665.     To aid the archiving and retrieval of of TeX-related files, a TUG
  666.     working group developed the Comprehensive TeX Archive Network
  667.     (CTAN).  Each CTAN site has identical material, and maintains
  668.     authoritative versions of its material.  These collections are
  669.     extensive; in particular, almost everything mentioned in this
  670.     document is archived at the CTAN sites, even if not explicitly
  671.     stated.
  672.  
  673.     The CTAN sites are currently ftp.dante.de (129.206.100.192)
  674.     ftp.tex.ac.uk (134.151.44.19), and pip.shsu.edu (192.92.115.10). 
  675.     The organization of TeX files on all these sites is identical and
  676.     starts at ./tex-archive. To reduce network load, please use the
  677.     CTAN site or mirror closest to you. A complete and current list
  678.     of CTAN sites and mirrors can be obtained by using the finger
  679.     utility to finger ctan_us@ftp.SHSU.edu.
  680.  
  681.     To find software at a CTAN site, use anonymous ftp to the host,
  682.     and then execute the command `quote site index <search-term>'.
  683.  
  684.     The mail servers of the CTAN sites are not yet identical, but this is
  685.     planned. Here are the current methods of access via electronic mail:
  686.       - For the UK site, send a message to texserver@tex.ac.uk. The
  687.         first non-blank line of the message must contain a valid
  688.         TeXserver command (help, directory, files, whereis, search,
  689.         or path). The program will then mail you a response notifying
  690.         you that your request has been received. If you fail to get a
  691.         response from the TeXserver, you may need to use the ``path''
  692.         command to help the program out. For Internet users the
  693.         return address is of the form name%site@nsfnet-relay, while
  694.         for Bitnet and EARN it is name%site@earn-relay (i.e., include
  695.         a line that says ``path name%site@nsfnet-relay'' along with a
  696.         line containing ``help''). 
  697.       - For ftp.dante.de, send a message containing the line
  698.         ``help'' to mail-server@ftp.dante.de.
  699.       - For the SHSU site, send a message with the line "help" to
  700.         ftpmail@ftp.shsu.edu. This provides an ftp-like interface
  701.         through mail.
  702.  
  703.     There are several other repositories of TeX material available:
  704.       - ftp.cs.ruu.nl (131.211.80.17) also contains a substantial TeX
  705.         archive with ftp access. To use it via email, send a message
  706.         containing the line ``help'' to mail-server@cs.ruu.nl. This mail 
  707.         server can send binary files in a variety of different formats.
  708.       - There are LISTSERV facilities for TeX at LISTSERV@DHDURZ1.BITNET. 
  709.         Send a message containing the line ``help'' to this address.
  710.       - For users on BITNET, access to anonymous ftp for some files can
  711.         be obtained indirectly by sending mail to BITFTP@PUCC.BITNET.
  712.         Send a message containing the line ``help'' to this address for
  713.         more information.
  714.      
  715.     There is also the DECUS TeX collection, a collection of TeX material
  716.     for VMS, Unix, MS-DOS, and the Macintosh. It is available via 
  717.     anonymous ftp from wuarchive.wustl.edu (128.252.135.4) in ./decus/tex.
  718.     It can also be obtained from the DECUS Library (reference number 
  719.     VS0058) in the US, or through your DECUS office outside of the US. To 
  720.     contact the DECUS Library, send mail or call:
  721.                  The DECUS Program Library
  722.                  334 South Street SHR3-1/T25
  723.                  Shrewsbury, MA 01545-4195
  724.                  (800)332-3755
  725.     The last update to this collection was in February 1991, so it is old.
  726.      
  727.     Another good source of information is NETWORK SOURCES OF TeX WARE by
  728.     Peter Flynn which appeared in TeXhax, volume 90, issues 45-47 (in
  729.     May 1990).      
  730.  
  731. 23) How do I use PostScript fonts with LaTeX?
  732.  
  733.     The best way to do this is to install LaTeX2e (see question 41)
  734.     and use the PSNFSS2e package written by Sebastian Rahtz. It is
  735.     available from all the major archives mentioned in question
  736.     22. Other methods for using PostScript fonts in LaTeX are
  737.     cumbersome at best.
  738.  
  739. 24) How can I convert from format Y to TeX or LaTeX, and vice-versa?
  740.  
  741.     troff - TROFF-TO-LATEX.TAR-Z is available via anonymous ftp from
  742.       wsmr-simtel20.army.mil (192.88.110.20) in the directory 
  743.       pd2:<unix-c.textproc>. This program, written by Kamal Al-Yahya 
  744.       at Stanford, assists in the translation of a troff document into 
  745.       LaTeX format.  It recognizes most -ms and -man macros, plus most 
  746.       eqn and some tbl preprocessor commands. Anything fancier needs 
  747.       to be done by hand.  Two style files are provided.  There 
  748.       is also a man page (which converts very well to LaTeX :-).  
  749.       The program is copyrighted but free. An enhanced version of this
  750.       program, tr2latex, is available from 
  751.       ftp.informatik.rwth-aachen.de (137.226.112.172) in ./pub/TeX. 
  752.       The DECUS TeX distribution (see question 22) also contains a program
  753.       which converts troff to TeX. If you are interested in obtaining a copy
  754.       of this program without getting the entire DECUS TeX distribution, 
  755.       send the command: SENDME TROFFTOTEX in the body of a mail message to
  756.       FILESERV@SHSU.BITNET (FILESERV@SHSU.edu), or use anonymous ftp to the
  757.       directory [.TROFFTOTEX] on Niord.SHSU.edu (192.92.115.8). 
  758.  
  759.     scribe - Mark James has a copy of scribe2latex he has been
  760.       unable to test but which he will let anyone interested have.
  761.       Send email to jamesm@procor.dialogic.com. The program was written
  762.       by Van Jacobson of Lawrence Berkeley Laboratory.
  763.  
  764.     wordperfect -  wp2latex.zip is available on wuarchive.wustl.edu
  765.       (128.252.135.4) in the directory ./mirrors/msdos/tex and on
  766.       wsmr-simtel20.army.mil (192.88.110.20) in the directory pd1:<msdos.tex>.
  767.       This is a PC program written in Turbo Pascal by R. C. Houtepen at
  768.       the Eindhoven University in the Netherlands.  It converts
  769.       WordPerfect 5.0 documents to LaTeX.  Pascal source is included.
  770.       Users find it ``helpful'' and ``decent'' in spite of some
  771.       limitations. It gets high marks for handling font changes.
  772.       Limitations include no indices, table of contents, margins or
  773.       graphics.  It also won't handle the new features of WordPerfect
  774.       5.1, in particular the equation formatter. The program is
  775.       copyrighted but free.
  776.  
  777.       Glenn Geers of the University of Sydney (glenn@qed.physics.su.oz.au)
  778.       is translating wp2latex into C and adding some WordPerfect 5.1
  779.       features, in particular its equation handling.  This is an ongoing
  780.       project; the most recent version can be retrieved via anonymous ftp
  781.       from suphys.physics.su.oz.au (129.78.129.1) in ./wp2latex. It was 
  782.       posted to alt.sources on 8 August 1990.
  783.  
  784.       Commercial packages are available for DOS which convert from
  785.       WordPerfect to LaTeX, and from TeX and LaTeX to WordPerfect, but
  786.       I am unaware of any free products which do this.
  787.  
  788.     PC-Write - pcwritex.arc is available on wuarchive.wustl.edu
  789.       (128.252.135.4) in directory mirrors/msdos/tex and on
  790.       wsmr-simtel20.army.mil (192.88.110.20) in directory pd1:<msdos.tex>.
  791.       This is a print driver for PC-Write that ``prints'' a PC-Write V2.71
  792.       document to a TeX-compatible disk file.  It was written by Peter
  793.       Flynn at University College, Cork, Ireland.  It is public domain.  
  794.  
  795.     runoff - Peter Vanroose (vanroose@esat.kuleuven.ac.be) has 
  796.       written a RUNOFF-to-TeX conversion program in VMS Pascal.  It is 
  797.       available from comp.text archives (they do exist, don't they?  The 
  798.       program was submitted in December 1987) or from the author 
  799.       (peter@dit.lth.se) or from Mark James (jamesm@procor.dialogic.com).
  800.  
  801.     refer/Tib - There are a few programs for converting bibliographic data 
  802.       between BibTeX and refer/Tib formats.  They are available via 
  803.       anonymous ftp from ftp.ai.mit.edu (128.52.32.11) in the 
  804.       directory ./pub/refer-to-bibtex.  In spite of the directory name, 
  805.       it also contains a  shell script to convert BibTeX to REFER as 
  806.       well. Unfortunately, this collection is not maintained.
  807.  
  808.     RTF - A program for converting Microsoft's Rich Text Format to TeX
  809.       is available via anonymous ftp from astro.princeton.edu
  810.       (128.112.128.131) in ./pub/rtf2TeX.tar.Z. It was written and is
  811.       maintained by Robert Lupton (rhl@astro.princeton.edu). There is
  812.       also an rtf2LateX written by Erwin Wechtl available from 
  813.       ftp.vmars.tuwien.ac.at (128.130.39.16) in ./pub/misc.
  814.  
  815.     Microsoft Word - A rudimentary program for converting MS-Word
  816.       to LaTeX is wd2latex, for MS-DOS, available via anonymous ftp
  817.       from any CTAN site (see question 22). A better idea, however, 
  818.       is to convert the document to RTF format and use the RTF 
  819.       converter mentioned above.
  820.     
  821.     In addition, a group at Ohio State University is working on a common
  822.     document format based on SGML.  In theory any format could be
  823.     translated to or from this one.  Also, Framemaker supposedly has
  824.     ``import filters'' to aid in the translation from alien formats
  825.     (presumably including TeX) to Framemaker; perhaps other desktop
  826.     publishing programs have similar things.
  827.       
  828. 25) How do I get a file into the major style repositories?
  829.     
  830.     Use anonymous ftp to any CTAN archive (see question 22) and
  831.     retrieve the file README.uploads in the root directory. It contains
  832.     instructions for uploading files and notifying the appropriate
  833.     people for that site.
  834.  
  835.     If you cannot use ftp, mail your contribution to sty-mgr@shsu.edu
  836.     and it will be passed along. You will make everyone's life easier
  837.     if you choose a descriptive and unique name for your submission, so
  838.     it's probably good idea to browse through some of the styles
  839.     already available to insure your style file's name is not already
  840.     in use.
  841.  
  842. 26) Where can I get font Y?
  843.  
  844.     A comprehensive list of METAFONT fonts is posted to Comp.fonts
  845.     about once every six weeks by Lee Quin (lee@sq.sq.com). It contains
  846.     both commercial fonts and fonts available via anonymous ftp. Most
  847.     of the fonts available via anonymous ftp are available from
  848.     the CTAN archives (see question 22). Also, the file wujastyk.txh
  849.     ./tex-archive/digests/texhax/txh/wujastyk.txh is a copy of
  850.     Dominik Wujastyk's font article, and contains information on
  851.     METAFONT fonts as well.
  852.  
  853. 27) Where can I get a dvi driver for the HP LaserJet?
  854.  
  855.     PC - The emtex package mentioned in question 19 contains a driver for
  856.        the LaserJet, dvihplj. 
  857.  
  858.     Version 2.10 of the Beebe drivers support the LaserJet. These drivers
  859.     will compile under Unix, VMS, and on the Atari ST and DEC-20's. They
  860.     are available from ftp.math.utah.edu (128.110.198.34) in ./pub/tex/dvi.
  861.  
  862. 28) TeX and LaTeX are hyphenating words weirdly. What can I do?
  863.  
  864.     You have a version mismatch problem. The hyphenation algorithm changed
  865.     between version 2.9 and 3.0. If you are using TeX version 3.0 or
  866.     later, make sure you have plain.tex and lplain.tex files with a
  867.     version number of at least 3.0.
  868.  
  869.     For those of you curious about the change, here's what happened:
  870.     in versions of TeX before 3.0 the hyphenation algorithm would not
  871.     break a word if the part before the break was not at least two
  872.     characters long, and the part after the break at least three 
  873.     characters long. Starting with version 3.0 two integer parameters,
  874.     \lefthyphenmin and \righthyphenmin, control the length of these
  875.     fragments. These are set to 2 and 3, respectively, in the new
  876.     plain and lplain formats. They can be set to any value, of course,
  877.     but if \lefthyphenmin + \righthyphenmin is greater than 62, all
  878.     hyphenation is suppressed.
  879.  
  880. 29) How can I convert a TeX or LaTeX file into a plain ASCII file,
  881.     with all the formatting intact, a la nroff?
  882.  
  883.     Ralph Droms (droms@bucknell.edu) has a style file and a C program
  884.     that provide the LaTeX equivalent of nroff. Although it doesn't do
  885.     a good job with tables and math, it's the best way to convert that
  886.     I've seen. The software is available for anonymous ftp from
  887.     sol.cs.bucknell.edu (134.82.1.8) in ./droms/txt-dist.tar. This is a
  888.     modification of the dvi2tty program; the original often does an
  889.     acceptable job and can be gotten from any CTAN site (see question 22).
  890.  
  891.     Another possibility is to use screen.sty, available from all the
  892.     major archives. However you need a program called crudetype to
  893.     process the resulting dvi file. It is available from
  894.     emx.utexas.edu (128.83.186.11) in
  895.     ./pub/mnt/source/tex/tex-3.0/DVIware/lpr-viewers/crudetype and
  896.     from ftp.uni-stuttgart.de (129.69.8.13) in
  897.     ./tex-archive/dviware/screenview. Another possibility is to use
  898.     the LaTeX-to-ASCII conversion program, l2a, available from
  899.     comp.sources.misc archives (one archive site is ftp.uu.net
  900.     (192.48.96.9)), although this is really more of a de-TeXing
  901.     program. If you are running under Unix and have C++ and perl, you
  902.     might try Jonathan Monsarrat's LameTeX package (which actually
  903.     does much more than this), available from wilma.cs.brown.edu
  904.     (128.148.33.66) in ./pub/lametex.tar.Z.
  905.  
  906. 30) How do I enlarge TeX? I keep getting `memory capacity exceeded'
  907.     errors.
  908.  
  909.     Most of the time, a ``memory capacity exceeded'' error can be fixed
  910.     without enlarging TeX.  The most common causes are unmatched braces,
  911.     extra-long lines, and poorly-written macros.  Extra-long lines
  912.     are often introduced when files are transferred incorrectly between
  913.     operating systems.  (The tell-tale sign of an extra-long line error
  914.     is when the complaint is that the `buf_size' has overflowed.)
  915.  
  916.     If you really need to extend your TeX's capacity, the proper method
  917.     varies depending on your installation.  In the purest form, you
  918.     change the parameters in module 11 (``The following parameters can
  919.     be changed...'')  In less pure forms, you might need to modify a
  920.     change file, or perhaps change some environment variables.  Consult
  921.     the documentation that came with your particular implementation.
  922.  
  923. 31) In LaTeX, I used \pagestyle{empty}, but the first page is still 
  924.     numbered. What do I do?
  925.  
  926.     If you see this, you are using the \maketitle command too. This is
  927.     not a bug but a feature! The standard LaTeX styles are written so
  928.     that initial pages (pages containing a \maketitle, \part, or \chapter)
  929.     have a different page style than the rest of the document. Hence, the
  930.     above commands internally issue a \thispagestyle{plain}. This is
  931.     usually not acceptable behavior is the page style is `empty'.
  932.  
  933.     Possible workarounds include:   
  934.      - Put \thispagestyle{empty} immediately after the \maketitle command, 
  935.        with no blank line between them.
  936.      - Use fancyheadings.sty, available from any CTAN (see question 22).
  937.        In this style, the style for initial pages can be customized as well.
  938.  
  939. 32) Where do I find documentation about BibTeX?
  940.  
  941.     BibTeX, a program originally designed to produce bibliographies in
  942.     conjunction with LaTeX, is explained in Section 4.3 and Appendix B 
  943.     of Leslie Lamport's LaTeX manual.  The ``BibTeXing'' document, 
  944.     contained in the file btxdoc.tex, gives a more complete description.
  945.     _The LaTeX Companion_ also has information on BibTeX and writing 
  946.     BibTeX style files.
  947.  
  948.     The ``Designing BibTeX Styles'' document, contained in the file 
  949.     btxhak.tex, explains the postfix stack-based language used to
  950.     write BibTeX styles (.bst files).  The file btxbst.doc is the template
  951.     file for the four standard styles (plain, abbrv, alpha, unsrt). It
  952.     also contains the documentation for them.
  953.  
  954.     The current Unix-BibTeX man page, contained in the file
  955.     bibtex.1, was updated in January 1992 and is about one page long.
  956.     There's an old and obsolete version floating around, written in 1985
  957.     before ``BibTeXing'' and ``Designing BibTeX Styles'' appeared, that is
  958.     several pages long.  You should ignore it (or throw it away), since it
  959.     describes BibTeX version 0.98, style files of which are incompatible 
  960.     with the current version, 0.99 (to be precise, 0.99c).
  961.  
  962.     All files mentioned in this answer are available via anonymous ftp
  963.     from labrea.stanford.edu (36.8.0.112) in the BibTeX ftp area, 
  964.     tex/bibtex. All the non-Unix files should be available on any system 
  965.     that runs BibTeX; if they're not on your system, please complain to 
  966.     your BibTeX installer or to your distribution source.
  967.  
  968. 33) How do I use BibTeX with plain TeX?
  969.  
  970.     The file btxmac.tex contains TeX macros and documentation for using
  971.     BibTeX with plain TeX, either directly or with Karl Berry's Eplain
  972.     package. It is available via anonymous ftp from labrea.stanford.edu
  973.     (36.8.0.112) in tex/bibtex (see question 32 for more information 
  974.     about BibTeX).
  975.  
  976. 34) How do I draw Feynman diagrams in LaTeX?
  977.  
  978.     Michael Levine's macro package for drawing Feynman diagrams in LaTeX
  979.     is available via mail-server from physics.utoronto.ca. Send a message
  980.     containing the line ``send INDEX'' to mail-server@physics.utoronto.ca
  981.     for information on how to retrieve it. It is also available from any
  982.     CTAN site or mirror (see question 22).
  983.  
  984. 35) What is the New Font Selection Scheme (NFSS)?
  985.  
  986.     NFSS is an extension to LaTeX written by Frank Mittelbach and Rainer
  987.     Sch\"opf. It is described in TUGboat, volume 10 (1989), No. 2.
  988.     In traditional typesetting, fonts are described by four parameters:
  989.     the family (e.g., computer modern), the series (i.e., the weight and
  990.     width of the font, like light or bold), the shape (e.g., italic), and
  991.     the size. NFSS is a mechanism allowing the user to change any of these
  992.     independently. NFSS makes it relatively easy to use nonstandard fonts
  993.     such as the PostScript ones with LaTeX, and easy to change math fonts.
  994.     It also allows dynamic loading of fonts at runtime (not when the
  995.     format file is created).
  996.  
  997.     NFSS is no longer supported for LaTeX version 2.09, but is standard
  998.     with LaTeX2e (see question 41).
  999.  
  1000.     There is one caveat that applies to LaTeX documents written for
  1001.     the OLD scheme: some of them use special styles for special fonts
  1002.     which will not work under the NFSS.
  1003.  
  1004. 36) In LaTeX, my cross-references for floats (figures and tables) are
  1005.     incorrect. What's wrong?
  1006.  
  1007.     The \label command must come after the \caption command, or
  1008.     be part of it. For example,
  1009.        \begin{figure}               \begin{figure}
  1010.        \caption{A Figure}    or     \caption{A Figure\label{fig}}
  1011.        \label{fig}                  \end{figure}
  1012.        \end{figure}
  1013.  
  1014. 37) I want to change the margins in LaTeX. What can I do?
  1015.  
  1016.     This answer first helps you change the margins throughout a
  1017.     document, then tells you how to change the margins in a portion
  1018.     of the document.
  1019.  
  1020.     Perhaps the easiest way to get more out of a page in LaTeX is to
  1021.     get fullpage.sty, available from all the major archive servers
  1022.     mentioned in question 22. This sets the margins of the page identical
  1023.     to those of Plain TeX, i.e., 1-inch margins at all four sides of the
  1024.     paper. It also contains an adjustment for A4 paper.
  1025.  
  1026.     Here is a brief explanation of what's going on with the page
  1027.     parameters in LaTeX. They are explained in section C.4.2 of the
  1028.     LaTeX manual (p. 163). The margin parameters represent measurements
  1029.     made to the DVI file. The origin in DVI coordinates is one inch
  1030.     from the top of the paper and one inch from the left side. This
  1031.     explains the ``one inch less than'' terminology used in the LaTeX
  1032.     manual. In DVI coordinates, positive horizontal measurements extend
  1033.     right across the page, and positive vertical measurements extend down
  1034.     the page. Thus, for margins closer to the left and top edges of the
  1035.     page than 1 inch, the corresponding parameters, e.g.,
  1036.     \evensidemargin, \oddsidemargin, \topmargin, can be set to negative
  1037.     values.
  1038.  
  1039.     Finally, to change the margins of a document within the document,
  1040.     modifying the parameters listed on page 163 will not work. They
  1041.     can only be changed in the preamble of the document, i.e, before
  1042.     the \begin{document} statement. To adjust the margins within a
  1043.     document we define an environment which does it:
  1044.       \newenvironment{changemargin}[2]{\begin{list}{}{
  1045.          \setlength{\topsep}{0pt}\setlength{\leftmargin}{0pt}
  1046.          \setlength{\rightmargin}{0pt}
  1047.          \setlength{\listparindent}{\parindent}
  1048.          \setlength{\itemindent}{\parindent}
  1049.          \setlength{\parsep}{0pt plus 1pt}
  1050.          \addtolength{\leftmargin}{#1}\addtolength{\rightmargin}{#2}
  1051.          }\item }{\end{list}}
  1052.     This environment takes two arguments, and will indent the left
  1053.     and right margins by their values, respectively. Negative values
  1054.     will cause the margins to be widened, so
  1055.     \begin{changemargin}{-1cm}{-1cm} widens the left and right margins
  1056.     by 1cm.
  1057.  
  1058. 38) How do I find the width of a letter, word, or phrase in TeX?
  1059.  
  1060.     Put the word in a box, and measure the width of the box. For example,
  1061.         \setbox0=\hbox{hi}
  1062.         width=\wd0
  1063.     Note that if the quantity in the hbox is a phrase, the actual 
  1064.     measurement only approximates this width, since the interword glue
  1065.     can be adjusted in paragraph mode.
  1066.  
  1067.     In LaTeX, the following works (taken from the manual):
  1068.         \newlength{\gnat}
  1069.         \settowidth{\gnat}{\em small}
  1070.     This sets the value of the length command \gnat to the width of ``small''
  1071.     in emphasized text.
  1072.  
  1073. 39) In LaTeX, is there a comment or ``ignore'' environment with which
  1074.     I can exclude blocks of text from the .dvi file?
  1075.  
  1076.     Rainer Sch\"opf's verbatim.sty provides a comment environment which
  1077.     excludes everything between \begin{comment} and \end{comment}. It is
  1078.     available via anonymous ftp from any CTAN site (see question 22) in
  1079.     ./tex-archive/macros/latex/distribs. Several files are needed to
  1080.     install the package. A more general environment for doing this is
  1081.     comment.sty, also available from the CTAN sites in
  1082.     ./tex-archive/macros/latex/contrib/misc.
  1083.  
  1084. 40) Where can I find a spelling checker for my TeX file?
  1085.  
  1086.     For Unix, ispell is probably the program of choice. It is available
  1087.     from any CTAN site (see question 22) in ./tex-archive/support/ispell.
  1088.  
  1089.     For DOS, jspell is an extended version of ispell, and is available via
  1090.     anonymous ftp from oak.oakland.edu (141.210.10.117) in 
  1091.     ./pub/msdos/tex/jspell*.zip.
  1092.  
  1093.     For VMS, a spell checker can be found via anonymous ftp from ftp.spc.edu
  1094.     in  [.MACRO32.SAVESETS]. Retrieve SPELL.ZIP and SPELL_DICTIONARY.ZIP. 
  1095.  
  1096. 41) What is LaTeX2e?
  1097.  
  1098.     LaTeX2e is the new standard version of LaTeX, prepared and
  1099.     supported by the LaTeX3 project team. It is the current version of
  1100.     LaTeX and is available from any CTAN site (see question 22) in
  1101.     ./tex-archive/macros/latex. LaTeX 2.09 is no longer supported.
  1102.  
  1103.     LaTeX2e is upwardly compatible with LaTeX 2.09, but supports many new
  1104.     features, including:
  1105.      - NFSS (see question 35) is now standard.
  1106.      - SliTeX is consolidated into it, and there is no longer a need for
  1107.        a separate program.
  1108.      - The output routine gives better control of floating environments,
  1109.        such as figures.
  1110.      - There is a documented interface to style files.
  1111.      - Enhanced box commands, e.g., options to specify the height of a 
  1112.        minipage.
  1113.      - \ref is now robust and can be used in \caption.
  1114.      - \newcommand can define commands with optional arguments.
  1115.      - A standard package for color and graphics inclusion.
  1116.  
  1117.     Since LaTeX2e is supported, you can report bugs or problems with it by
  1118.     typing `latex latexbug' and sending the report it generates to 
  1119.     latex-bugs@rus.uni-stuttgart.de.
  1120.  
  1121. 42) In LaTeX, how can I define a new log-like function?
  1122.  
  1123.     Use the \mathop command, as in:
  1124.          \newcommand{\diag}{\mathop{\mathrm{diag}}}
  1125.  
  1126.     Subscripts and superscripts to \diag will be done identically to \lim.
  1127.     If you want your subscripts and superscripts placed to the right, do:
  1128.          \newcommand{\diag}{\mathop{\mathrm{diag}}\nolimits}
  1129.  
  1130.     Older versions of LaTeX may not define \mathrm; alternatively, use
  1131.     {\rm diag}.
  1132.  
  1133. 43) In LaTeX, how do I put a \sqrt in my \caption statement?
  1134.  
  1135.     \sqrt is a fragile command and the argument to \caption is ordinarily
  1136.     a moving argument. Therefore \sqrt needs to be preceded with a \protect
  1137.     command.
  1138.  
  1139. 44) In LaTeX, how do I get thin and thick \hlines in a table?
  1140.  
  1141.     In the preamble, do: 
  1142.          \setlength{\doublerulesep}{\arrayrulewidth}.
  1143.     Then in a table or array, do:
  1144.          <stuff in the table>  \\\hline         %thin hline
  1145.          <more stuff in table> \\\hline\hline   %thick hline
  1146.  
  1147. 45) In LaTeX, how do I number the bibliography using Arabic numbers without
  1148.     square brackets or using superscripts?
  1149.  
  1150.     In a style file (or between \makeatletter ... \makeatother, see
  1151.     question 6), put:
  1152.          \renewcommand\@biblabel[1]{#1.}     % Arabic numbers, no brackets
  1153.          \renewcommand\@biblabel[1]{$^{#1}$} % Superscripts
  1154.  
  1155. 46) In LaTeX, why are my cites all numbered zero?
  1156.  
  1157.     Your document style and your version of LaTeX are incompatible.
  1158.     Since this may reflect an incomplete update done at some point,
  1159.     you should probably get the complete distribution (see question
  1160.     22).
  1161.  
  1162.     This problem usually occurs using an old university style file
  1163.     which is not maintained. If you are going to correct the style
  1164.     file, the definition of \thebibliography needs to be updated from
  1165.     article.cls (or article.sty).
  1166.  
  1167. 47) In LaTeX, my figures get put on a page by themselves with too much
  1168.     whitespace, but when I tried \begin{figure}[t] they get printed at
  1169.     the end. Why?
  1170.  
  1171.     Your figures are bigger than \floatpagefraction, but you are
  1172.     willing to accept pages with less text than the default.  Use:
  1173.          \renewcommand\floatpagefraction{.9}
  1174.          \renewcommand\topfraction{.9}
  1175.          \renewcommand\bottomfraction{.9}
  1176.          \renewcommand\textfraction{.1}
  1177.  
  1178.     You can adjust the cut-off value if you like, but it makes no
  1179.     sense to go higher than .95 (LaTeX's default value is only .5).
  1180.     Also, the first 3 values should be equal, and the last should be
  1181.     1 - \floatpagefraction.  Otherwise, you are likely to get floats
  1182.     flushed to the end.
  1183.  
  1184. 48) In LaTeX, how do I make a line break in a section title?
  1185.  
  1186.     It is better to try to prevent bad breaks by using ~ than to force
  1187.     good breaks. Unfortunately, LaTeX's default styles make titles with
  1188.     flush margins and most other styles have followed, so this may not
  1189.     work in many cases. You should definitely avoid hyphenation in titles.
  1190.  
  1191.     To force line breaks in a title, but not in the table of contents,
  1192.     use the optional argument for \section:
  1193.          \section[This is the Title]{This is\\ the Title}
  1194.  
  1195.     One benefit of this is that \\ is safe and no \protect is needed.
  1196.  
  1197. 49) In LaTeX, how do I number equations by section?
  1198.  
  1199.     In a style file (or between \makeatletter ... \makeatother, see
  1200.     question 6), put:
  1201.          \renewcommand\theequation{\thesection.\arabic{equation}}
  1202.          \@addtoreset{equation}{section}
  1203.  
  1204.     If you have chapters with a preamble that comes before the first
  1205.     section, you should not put equations there, as you will get funny
  1206.     numbers like 3.0.1. There are also two style files available from
  1207.     any CTAN site called seceqn.sty and apeqnum.sty. The first numbers
  1208.     equations by section, and the second gives individual equation
  1209.     numbers to equations in the appendix.
  1210.  
  1211. -- 
  1212. Bobby Bodenheimer                @hot.caltech.edu
  1213. // ARPA  : bobby@hot.caltech.edu                |
  1214. // BITNET: bobby@caltech.bitnet                 | Woof!
  1215. // UUCP  : {amdahl,ames!elroy}!cit-vax!bobby    | 
  1216.  
  1217.